Favicon

You are here: Home > API Reference > AOSP > Android (Non Gms) Devices > List non-GMS Android devices

List non-GMS Android devices

Required Permission: mdm.aosp.device.list

Retrieve non-GMS Android devices for the enterprise using the lean list response shape.

GET
https://api.applivery.io/v1/organizations/{organizationId}/mdm/aosp/enterprise/devices 
curl -X GET "https://api.applivery.io/v1/organizations/{organizationId}/mdm/aosp/enterprise/devices" \
  -H "Authorization: Bearer <YOUR_API_KEY>"
const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/mdm/aosp/enterprise/devices", {
  method: "GET",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
  },
});

const data = await response.json();
import requests

response = requests.get(
    "https://api.applivery.io/v1/organizations/{organizationId}/mdm/aosp/enterprise/devices",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
)

data = response.json()

Request

Send your API key in the request header authorization
Example: Authorization: Bearer <token>

organizationId string
required
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

page integer
optional
Page number for paginated AOSP device results.
limit integer
optional
Maximum number of AOSP devices to return per page.
sort string
optional
Sort expression applied to the AOSP device list.
Match pattern: ^[\w.]*((:asc)|(:desc))?$
mdm-user string
optional
Filter devices associated with a specific MDM user identifier.
Match pattern: ^[a-fA-F0-9]{24}$
aos-policy string
optional
Filter devices linked to a specific directly assigned AOSP policy.
Match pattern: ^[a-fA-F0-9]{24}$
show-deleted any
optional
Include deleted devices in the result set.
segmentId integer
optional
Optional segment identifier used to scope the resource within the organization.
expandTo string
optional
Segment expansion mode applied when filtering by segment.
ancestorschildren
state any
optional
Filter devices by one or more backend states.
tags any
optional
Filter devices that contain one or more of the provided tags.

Responses

200 Response application/json
status boolean required
data object required
items array [object] required
id string required
Identifier of the AOSP device.
Match pattern: ^[a-fA-F0-9]{24}$
organizationId string required
Identifier of the organization that owns the AOSP enterprise resource.
Match pattern: ^[a-fA-F0-9]{24}$
aosEnterpriseId string required
Identifier of the AOSP enterprise configuration associated with this resource.
Match pattern: ^[a-fA-F0-9]{24}$
pushNotificationProvider string optional
Optional push notification provider override used for this enterprise or resource.
Match pattern: ^[a-fA-F0-9]{24}$
segmentId integer optional
Optional segment identifier used to scope the resource within the organization.
≥ 0 · ≤ 9007199254740991
displayName string optional
Optional human-friendly label shown in the dashboard.
≤ 256 characters
tags array required
Free-form labels used to group and filter AOSP resources in the dashboard.
state string required
Current backend-managed lifecycle state of the device.
PROVISIONING ACTIVE DISABLED PENDING_DISENROLL DELETED
type string required
Top-level MDM device type for this resource.
aosp
subType string required
Subtype of the AOSP resource returned by this endpoint.
device
mdmUser object optional
Optional dashboard user metadata associated with the device.
aosPolicyId string optional
Identifier of the directly assigned AOSP policy, when present.
Match pattern: ^[a-fA-F0-9]{24}$
aosPolicy object optional
Summary of the effective directly assigned AOSP policy.
deviceAosPolicy object optional
Expanded effective device policy returned for the device detail view.
aosPolicyAssignments array [object] required
Ordered AOSP policy assignments used to compose the effective device policy.
devicePolicyStatus object optional
Comparison between the effective policy and the last reported device state.
config object optional
Last known AOSP device configuration and reports recorded by the backend.
summary object optional
Latest backend summary captured from device reports and inventory processing.
stateHistory array [object] optional
Historical record of state transitions recorded by the backend.
lastStatusReportTime string optional
Timestamp of the most recent status report received from the device.
enrolledDate string required
Timestamp when the device was enrolled, or resource creation time when unavailable.
updatedAt string required
Timestamp when the resource was last updated.
createdAt string required
Timestamp when the resource was created.
totalDocs integer required
≥ -9007199254740991 · ≤ 9007199254740991
limit integer required
≥ -9007199254740991 · ≤ 9007199254740991
hasPrevPage boolean required
hasNextPage boolean required
page integer required
≥ -9007199254740991 · ≤ 9007199254740991
totalPages integer required
≥ -9007199254740991 · ≤ 9007199254740991
prevPage integer required
≥ -9007199254740991 · ≤ 9007199254740991
nextPage integer required
≥ -9007199254740991 · ≤ 9007199254740991
{
    "status": true,
    "data": {
        "items": [
            {
                "id": "string",
                "organizationId": "string",
                "aosEnterpriseId": "string",
                "pushNotificationProvider": "string",
                "segmentId": 0,
                "displayName": "string",
                "tags": [
                    "string"
                ],
                "state": "PROVISIONING",
                "type": "aosp",
                "subType": "device",
                "mdmUser": {
                    "id": "string",
                    "email": "string"
                },
                "aosPolicyId": "string",
                "aosPolicy": {
                    "id": "string",
                    "name": "string",
                    "version": "string"
                },
                "deviceAosPolicy": {
                    "id": "string",
                    "organizationId": "string",
                    "aosEnterpriseId": "string",
                    "name": "string",
                    "description": "string",
                    "config": "string",
                    "private": true,
                    "segmentId": 0,
                    "exposeToChildren": true,
                    "agentConfiguration": {
                        "allowLocation": true,
                        "allowPackageTime": true,
                        "allowPackageTransfer": true,
                        "allowNetworkStatus": true,
                        "policyFeatures": {
                            "defaultViewFeature": "bookmarks",
                            "toggledFeatures": [
                                {
                                    "name": "bookmarks",
                                    "active": true
                                }
                            ],
                            "enableDefaultView": true
                        }
                    },
                    "assets": [
                        {
                            "mdmAssetId": "string",
                            "location": "string",
                            "assetName": "string",
                            "scope": "user"
                        }
                    ],
                    "assetsInfo": [
                        {}
                    ],
                    "applications": [
                        {
                            "aosApplicationId": "string",
                            "configuration": "string",
                            "action": "forceInstall",
                            "updatePolicy": {},
                            "customAppConfig": {}
                        }
                    ],
                    "applicationsInfo": [
                        {
                            "id": "string",
                            "organizationId": "string",
                            "aosEnterpriseId": "string",
                            "type": "build",
                            "config": {
                                "buildId": "string",
                                "applicationId": "string",
                                "filter": "string"
                            },
                            "info": {
                                "id": "string",
                                "bundleId": "string",
                                "name": "string",
                                "icon": "string",
                                "processedVersionName": "string",
                                "versionCode": "string",
                                "size": "string",
                                "originalExtension": "string",
                                "applicationInfo": {
                                    "id": "string",
                                    "slug": "string",
                                    "name": "string",
                                    "picture": "string"
                                },
                                "disabled": true,
                                "signatures": [
                                    {
                                        "sha1": "string",
                                        "sha256": "string"
                                    }
                                ]
                            },
                            "version": 0,
                            "updatedAt": "string",
                            "createdAt": "string"
                        }
                    ],
                    "certificateProviderIds": [
                        "string"
                    ],
                    "version": 0,
                    "updatedAt": "string",
                    "createdAt": "string"
                },
                "aosPolicyAssignments": [
                    {
                        "aosPolicyId": "string",
                        "aosPolicy": {
                            "id": "string",
                            "name": "string",
                            "version": "string"
                        },
                        "priority": 0
                    }
                ],
                "devicePolicyStatus": {
                    "pushed": true,
                    "audit": {
                        "name": "string",
                        "config": {
                            "version": "string"
                        },
                        "device": {
                            "version": "string"
                        }
                    }
                },
                "config": {
                    "deviceReport": {
                        "name": "string",
                        "userName": "string",
                        "managementMode": "string",
                        "state": "string",
                        "appliedState": "string",
                        "policyCompliant": true,
                        "nonComplianceDetails": [
                            {}
                        ],
                        "enrollmentTime": "string",
                        "lastStatusReportTime": "string",
                        "lastPolicyComplianceReportTime": "string",
                        "lastPolicySyncTime": "string",
                        "policyName": "string",
                        "appliedPolicyName": "string",
                        "appliedPolicyVersion": "string",
                        "apiLevel": 0,
                        "enrollmentTokenData": "string",
                        "enrollmentTokenName": "string",
                        "disabledReason": {},
                        "softwareInfo": {
                            "androidVersion": "string",
                            "androidDevicePolicyVersionCode": 0,
                            "androidDevicePolicyVersionName": "string",
                            "androidBuildNumber": "string",
                            "deviceKernelVersion": "string",
                            "bootloaderVersion": "string",
                            "androidBuildTime": "string",
                            "securityPatchLevel": "string",
                            "primaryLanguageCode": "string",
                            "deviceBuildSignature": "string",
                            "systemUpdateInfo": {}
                        },
                        "hardwareInfo": {
                            "brand": "string",
                            "hardware": "string",
                            "deviceBasebandVersion": "string",
                            "manufacturer": "string",
                            "serialNumber": "string",
                            "model": "string",
                            "batteryShutdownTemperatures": [
                                0
                            ],
                            "batteryThrottlingTemperatures": [
                                0
                            ],
                            "cpuShutdownTemperatures": [
                                0
                            ],
                            "cpuThrottlingTemperatures": [
                                0
                            ],
                            "gpuShutdownTemperatures": [
                                0
                            ],
                            "gpuThrottlingTemperatures": [
                                0
                            ],
                            "skinShutdownTemperatures": [
                                0
                            ],
                            "skinThrottlingTemperatures": [
                                0
                            ],
                            "enterpriseSpecificId": "string",
                            "euiccChipInfo": [
                                {}
                            ]
                        },
                        "displays": [
                            {}
                        ],
                        "previousDeviceNames": [
                            "string"
                        ],
                        "networkInfo": {
                            "imei": "string",
                            "meid": "string",
                            "wifiMacAddress": "string",
                            "networkOperatorName": "string",
                            "telephonyInfos": [
                                {}
                            ]
                        },
                        "memoryInfo": {},
                        "memoryEvents": [
                            {}
                        ],
                        "powerManagementEvents": [
                            {}
                        ],
                        "hardwareStatusSamples": [
                            {}
                        ],
                        "deviceSettings": {},
                        "user": {},
                        "systemProperties": {},
                        "securityPosture": {},
                        "ownership": "string",
                        "commonCriteriaModeInfo": {},
                        "appliedPasswordPolicies": [
                            {}
                        ],
                        "dpcMigrationInfo": {},
                        "defaultApplicationInfo": [
                            {}
                        ]
                    },
                    "managementMode": "MANAGEMENT_MODE_UNSPECIFIED",
                    "location": {
                        "latitude": 0,
                        "longitude": 0,
                        "accuracy": 0
                    },
                    "appliedPolicy": {
                        "policyId": "string",
                        "status": "success",
                        "appliedAt": "string",
                        "errorMessage": "string"
                    }
                },
                "summary": {},
                "stateHistory": [
                    {
                        "state": "PROVISIONING",
                        "date": "string",
                        "config": {}
                    }
                ],
                "lastStatusReportTime": "string",
                "enrolledDate": "string",
                "updatedAt": "string",
                "createdAt": "string"
            }
        ],
        "totalDocs": 0,
        "limit": 0,
        "hasPrevPage": true,
        "hasNextPage": true,
        "page": 0,
        "totalPages": 0,
        "prevPage": 0,
        "nextPage": 0
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4004
message string optional
Invalid Token
{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}
404 Response application/json
status boolean optional
false
error object optional
code number optional
3001
message string optional
Entity not found
{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}